home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / dev / misc / ARexxBox112.readme < prev    next >
Encoding:
Text File  |  1993-05-17  |  4.1 KB  |  118 lines
  1. Short: ARexx interface development tool V1.12
  2. Type: dev/misc
  3. Uploader: balzer@heike.informatik.uni-dortmund.de
  4.  
  5.     ARexxBox - ARexx Interface Design Tool
  6.     FREEWARE, (C) 1992 Michael Balzer
  7.  
  8. ARexxBox (inspired by the GadToolsBox) is a tool for designing
  9. ARexx interfaces for your programs, with the special goal to
  10. greatly simplify this procedure while coming as close as possible
  11. to the suggestions and ideas stated in the User Interface Style
  12. Guide's ARexx section.
  13.  
  14. ARexxBox is for ARexx, what GadToolsBox is for the GUI.
  15.  
  16. FEATURES:
  17.  
  18. -    Syntax and results of the ARexx commands follow
  19.     exactly the conventions suggested by the Style Guide,
  20.     e.g.  command arguments are parsed using the AmigaDOS
  21.     ReadArgs function, and the keywords VAR and STEM are
  22.     supported automatically.
  23.     
  24. -    Each command may have an unlimited number of arguments
  25.     and results.
  26.     
  27. -    All ReadArgs template options are allowed for arguments
  28.     and are supported automatically.  For results, the
  29.     switches /N and /M are supported.
  30.     
  31. -    Graphical user interface (designed using GadToolsBox :-).
  32.     
  33. -    Generates ANSI C or Oberon-2 source.
  34.     
  35. -    ARexxBox can generate source for CommandShells, shells
  36.     in which the user may enter ARexx commands directly
  37.     and view their output.
  38.     
  39. -    CommandShells can be used to execute external macros.
  40.     
  41. -    A program may open as many ARexx ports and
  42.     CommandShells as the system memory will allow.
  43.     
  44. -    ARexx commands can use an extended error return feature
  45.     using a secondary return code.
  46.     
  47. -    I already entered all standard commands suggested by
  48.     the Style Guide.  Example code for some of them is also
  49.     included.
  50.  
  51. REQUIREMENTS:
  52.  
  53. ARexxBox and the generated code will only run on AmigaOS 2.04
  54. (or better). The Box (but not the generated source) needs
  55. reqtools.library by Nico Francois.
  56.  
  57. HISTORY SINCE LAST RELEASE:
  58.  
  59. V1.12
  60.     FIXED: The HELP command produced Enforcer hits (strlen(0)).
  61.     (Report: Klaas Hermanns)
  62.     
  63.     ENHANCED: Introduced tag #2 for commands: External status flag,
  64.     "New" state of this flag will only be reset by external programs,
  65.     e.g. documentation aids like ARB2TeXinfo by Albert Weinert.
  66.     (Suggestion: Albert Weinert)
  67.     
  68.     FIXED: The command list was generated not alphabetically but
  69.     numerically sorted (by their IDs).
  70.     (Report: Klaas Hermanns)
  71.     
  72.     ENHANCED: Instead of the binary search algorithm, the Box now
  73.     generates a real finite state machine for searching of commands
  74.     (FindRXCommand). The binary search method had a big design flaw
  75.     with abbreviations on the alphabetically sorted list of commands.
  76.     (ATT: This has been implemented for C only up to now!)
  77.     (Report: Klaas Hermanns)
  78.     
  79.     FIXED: For SAS C, toupper() will be #undefined. Also there is now
  80.     the real function cast in the list of commands.
  81.     (Report: Klaas Hermanns)
  82.     
  83.     FIXED: The MIN and MAX results of Misc.arb/GETATTR have to be
  84.     numbers, of course.
  85.     (Report: Klaas Hermanns)
  86.     
  87.     FIXED: "Merge" trashed the command list when merging in existing
  88.     commands.
  89.     
  90.     CHANGED: Now declares the external library bases with their
  91.     appropriate types (C).
  92.     (Wunsch: Klaas Hermanns)
  93.     
  94.     CHANGED: In arb/advanced.arb, commands REQUESTNUMBER and
  95.     REQUESTSTRING, I changed the argument called "DEFAULT" to "DEFAULTNUM"
  96.     resp. "DEFAULTSTR" to avoid conflicts with the 'default' keyword in C.
  97.     (Report: Klaas Hermanns)
  98.     
  99.     ENHANCED: There's now another parameter for all interface functions
  100.     called "struct RexxMsg *rexxmsg", which will contain the address of
  101.     the message from REXX if called by ARexx. If called from a command
  102.     shell, it will contain NULL, so you can also use it to determine the
  103.     caller. This is to support GetRexxVar(), which needs this pointer.
  104.     (Report: Klaas Hermanns)
  105.     
  106.     FIXED: I now define toupper() as a function for GCC. The macro caused
  107.     problems by evaluating the parameter more than once.
  108.  
  109.     FIXED: The command shell parameter parsing had a bug (the ReadArgs
  110.     buffer wasn't cleared).
  111.  
  112.  
  113. Michael Balzer
  114. --
  115. Michael Balzer, Wildermuthstr.18, W-5828 Ennepetal, Germany
  116. At work: balzer@heike.informatik.uni-dortmund.de    // Pure
  117. At home: bilbo@bagsend.aworld.de  +49 2333 80908  \X/ Amiga
  118.